home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / macorg32.zip / HCOMP40.ZIP / HOTCOMP.DOC next >
Text File  |  1993-01-20  |  7KB  |  174 lines
  1.  
  2.  
  3.                         ╔═════════════════════════════╗
  4.                         ║  A MÄC's Place BBS Release  ║
  5.                         ╚═════════════════════════════╝
  6.  
  7.  
  8.                              The HotStuff Companion
  9.                              ~~~ ~~~~~~~~ ~~~~~~~~~
  10.  
  11.                               Copyright (C)1989,1990
  12.  
  13.                                  Version 4.0
  14.  
  15.                          Written By: John W. McNamara
  16.  
  17.                                MÄC's Place BBS
  18.  
  19.                              Dunn, North Carolina
  20.                                  919-891-1111 
  21.                         USR HST Dual Standard V.32 V.42
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.   HOTCOMP - Version 4.0                                        Page - 1
  32.  
  33.  
  34. ╔══════════════╗
  35. ║ Introduction ║
  36. ╚══════════════╝
  37.  
  38.   
  39.         As with all of MÄC's Place BBS software if you forget the
  40.         arguments to add after the program name.  Just type HOTCOMP
  41.         by itself and the instructions come up.
  42.         
  43.         Welcome to the HotStuff Companion !! The program was written
  44.         because of the need to strip the DOWNLOAD.TXT and CALLER files 
  45.         created by PCBoard (tm) of old,  outdated,  or unwanted files. 
  46.         When HotStuff runs, it may reflect reflect files  that  are no 
  47.         longer on your Bulletin Board System. There may be other  uses
  48.         for the HotStuff Companion program as well such as producing 
  49.         special files that other programs can read such as ProWho.
  50.          
  51.         The program uses a routine similar to the UNIX  Grep  command 
  52.         (although HOTCOMP's routine is unique !!).  It  will   search a 
  53.         file line by line for a string identified on the command  line.
  54.         If the string is NOT contained in the line that it is searching, 
  55.         that line is printed to a file. The original file is not changed.
  56.  
  57.  
  58. ╔═════════════════════════════╗
  59. ║ Files included in this ZIP: ║
  60. ╚═════════════════════════════╝
  61.  
  62.     HOTCOMP.EXE      - Main HotStuff Companion Executable File. 
  63.     HOTCOMP.DOC      - Information on HotStuff Companion Utility
  64.     HOTCOMP.HIS      - Programme Release History in reverse order
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.   HOTCOMP - Version 4.0                                        Page - 2
  74.  
  75.  
  76. ╔═══════════════════════════════╗
  77. ║ HotStuff Companion Operation: ║
  78. ╚═══════════════════════════════╝
  79.  
  80.         The operation of the  HotStuff  Companion  program is straight 
  81.         forward. The program is invoked from the command line:
  82.  
  83.  
  84.         CORRECT USAGE:
  85.  
  86.      HOTCOMP [inputfile] [outputfile] [filename1] [filename2] [filename3]
  87.  
  88.      InputFile:    File Containing Unwanted String. (DOWNLOAD.TXT or CALLERS)
  89.     OutputFile:    Temporary File for Output (Will be a Backup of Original)
  90.      FileName1:    Pattern to Strip from InputFile
  91.      FileName2:    Pattern to Strip from InputFile  (Optional)
  92.      FileName3:    Pattern to Strip from InputFile  (Optional)
  93.  
  94.         HOTCOMP is NOT case sensitive, it will parse ONLY upper
  95.         case for the text string [filename] variable.  However you can
  96.         enter it in lower case as the program will change it if it needs
  97.         too.
  98.  
  99.         HOTCOMP reads from the [InputFile] and outputs only the lines that 
  100.         Do NOT contain the search strings [filename] and writes them to the
  101.         [OutputFile].  HOTCOMP detects the difference between DOWNLOAD.TXT 
  102.         files and the CALLER log. HOTCOMP keeps  the  CALLERS  log  intact
  103.         including the 63 column format. The [InputFile]  and  [OutputFile]
  104.         are swapped at the completion of the program so that you  do not
  105.         have to rename the [OutputFile].   The HOTSTUFF program  is  now 
  106.         ready to run on the filename you had for the [InputFile].
  107.  
  108.         The program has other uses as well. For instance, if you need to
  109.         strip the DOWNLOAD.TXT file of all upload entries then you use the
  110.         command:
  111.  
  112.              HOTCOMP Download.Txt TempFile scanv dsz shez
  113.  
  114.          This will delete all references to the SCANV or DSZ or SHEZ 
  115.          programs.  This is  helpful in maintaining the record integrity.  
  116.          After getting a newer version of a program there is NO need to 
  117.          have the download file contain all the old versions of it.
  118.              
  119.              
  120.              HOTCOMP Download.Txt TempFile (U)
  121.  
  122.         HOTCOMP scans for the string '(U)' and parse out all  these lines.
  123.         When the program finishes, the file: Download.Txt will  contain
  124.         only download files [thus, it is stripped of all uploads] and the 
  125.         file "TempFile" will contain all the original information.
  126.  
  127.         The program has other uses as well. For instance, if you need to
  128.         strip the CALLERs log  file of Qwik Mail  entries then you use the
  129.         command:
  130.  
  131.              HOTCOMP CALLER TempFile .qwk
  132.  
  133.         HOTCOMP scans for the string '.qwk' and parse out all these lines.
  134.         When the program finishes, the file:     CALLER   will  contain
  135.         no lines containing any Qwik Mail Items.  The file  TempFile will
  136.         contain all the original information.
  137.  
  138.  
  139.   HOTCOMP - Version 4.0                                        Page - 3
  140.  
  141.         You  can  also  eliminate  a  specific string [filename] from the 
  142.         [InputFile].  For example, to  parse  any  reference  to  the DSZ 
  143.         program, you could use the command:
  144.  
  145.              HOTCOMP Download.Txt TempFile DSZ
  146.  
  147.         HOTCOMP would  scan  for  the  string 'DSZ' and  parse out
  148.         these lines.  When  the  program  completed, the file Download.Txt
  149.         would be cleaned of any reference to DSZ
  150.  
  151.  
  152.  
  153.  
  154. ╔══════════════════╗
  155. ║ Acknowledgements ║
  156. ╚══════════════════╝
  157.  
  158.         This program was conceived and created by John McNamara - the
  159.         SysOp of  MÄC's Place [919-891-1111] HST
  160.  
  161.         The HOTStuff Companion program is written in C and compiled with 
  162.         Microsoft C 6.0. The C language was choosen for writing all of
  163.         the MÄC's Place BBS  PCBoard utilities such as HOTCOMP  because
  164.         of its speed and flexibility. The MSC source is NOT available.
  165.  
  166.         If you have any  comments, suggestions  or improvements for  the
  167.         HotStuff Companion  program, please contact  MÄC's Place BBS 
  168.         919-891-1111  and  leaving a comment to the SysOp. The author, 
  169.         John McNamara can be contacted there or through the SHAREWARE 
  170.         conference which is one of the national PCRelay International 
  171.         network conferences. 
  172.  
  173.   Thanks !!
  174.